home *** CD-ROM | disk | FTP | other *** search
/ The Latest & Greatest Top 201 Games / The Latest and Greatest Top 201 Games (Maple Media)(1994).iso / elf / readme.doc < prev    next >
Text File  |  1992-01-25  |  20KB  |  384 lines

  1.  
  2.  
  3.                               ELFTREE (TM)
  4.  
  5.                 (C) Copyright 1988-1992 By Alan J. Avery
  6.  
  7.                         ALL RIGHTS RESERVED
  8.  
  9.                         Elvish Consulting
  10.                         1408 Noble Avenue
  11.                         Springfield, Illinois 62704
  12.                         (217)-698-8600 (8 a.m. to  9 p.m. CDT only, please)
  13.  
  14.                             DISCLAIMER
  15.  
  16.      Users of ELFTREE must accept this disclaimer of warranty:
  17.      "ELFTREE is supplied as is.  The author disclaims all warranties,
  18.      expressed or implied, including, without limitation, the warranties
  19.      of merchantability and of fitness for any purpose.  The author assumes
  20.      no liability for damages, direct or consequential, which may result
  21.      from the use of ELFTREE."
  22.  
  23.                             Thank You!
  24.  
  25.      Many people have told us that ELFTREE is vastly more powerful than
  26.      any commercial product sold as a `DOS shell'.  We've been praised
  27.      for making ELFTREE simple to use (it hasn't been easy!), fast (it's
  28.      written in Borland's Turbo C and Turbo Assembler), and intuitive.
  29.      We thank all of you who have used ELFTREE and have helped, with your
  30.      ideas, to make it such a wonderful product.  No programmer has the
  31.      skill to think of all the wonderful ideas blended together in this
  32.      version of ELFTREE.  Thank you all!
  33.  
  34.                            Why Shareware?
  35.  
  36.      This is a shareware version of ELFTREE.  It is distributed as
  37.      shareware for the following reasons:
  38.  
  39.        1. You get to use it for 30 days, to see how you like it.  We are
  40.            sure you will love it.
  41.        2. When you ask for features to be included, they are usually
  42.            added to the next release - often within a week!  This means
  43.            that you don't have to wait six months to a year for the next
  44.            upgrade, a problem with most commercial software.  Also, you
  45.            get to participate in the ongoing evolution of ELFTREE.
  46.        3. Advertising is expensive.  For example, a full page ad in one
  47.            issue of one computing magazine can cost $25,000.  By telling
  48.            10 of your friends about this great product, and giving them
  49.            a shareware copy of it, you can keep its cost extremely low.
  50.            If you upload the latest version to BBS's you know, you'll be
  51.            doing an even greater service.
  52.                                                         -- Page 2 --
  53.  
  54.                       Tell Me More About Shareware
  55.  
  56.      Shareware distribution gives users a chance to try software before
  57.      buying it. If you try a Shareware program and continue using it, you
  58.      are expected to register. Individual programs differ on details --
  59.      some request registration while others require it, some specify a
  60.      maximum trial period.  With registration, you get anything from the
  61.      simple right to continue using the software to an updated program
  62.      with printed manual.
  63.  
  64.      Copyright laws apply to both Shareware and commercial software, and
  65.      the copyright holder retains all rights, with a few specific
  66.      exceptions as stated below. Shareware authors are accomplished
  67.      programmers, just like commercial authors, and the programs are of
  68.      comparable quality.  The main difference is in the method of
  69.      distribution. The author specifically grants the right to copy and
  70.      distribute the software, either to all and sundry or to a specific
  71.      group. For example, some authors require written permission before
  72.      a commercial disk vendor may copy their Shareware.
  73.  
  74.      Shareware is a distribution method, not a type of software. You
  75.      should find software that suits your needs and pocketbook, whether
  76.      it's commercial or Shareware. The Shareware system makes fitting
  77.      your needs easier, because you can try before you buy.  And because
  78.      the overhead is low, prices are low also. Shareware has the ultimate
  79.      money-back guarantee -- if you don't use the product, you don't pay
  80.      for it!
  81.  
  82.                                  AGREEMENT
  83.  
  84.      ELFTREE is produced by a member of the Association of Shareware
  85.      Professionals (ASP).  ASP wants to make sure that the shareware
  86.      principle works for you. If you are unable to resolve a shareware-
  87.      related problem with an ASP member by contacting the member directly,
  88.      ASP may be able to help. The ASP Ombudsman can help you resolve a
  89.      dispute or problem with an ASP member, but does not provide technical
  90.      support for members' products. Please write to the ASP Ombudsman at
  91.      545 Grover Road, Muskegon, MI 49442 or send a CompuServe message via
  92.      CompuServe Mail to ASP Ombudsman 70007,3536."
  93.  
  94.      All users of ELFTREE must register and pay for their copies of ELFTREE
  95.      within 30 days of first use or their license is withdrawn.  For site
  96.      licensing, please refer to the file SITELICE.DOC elsewhere in this
  97.      package.  If this file is missing, please contact Elvish Consulting at
  98.      (217) 698-8600 for a free replacement.
  99.  
  100.      Anyone distributing ELFTREE for any kind of remuneration must first
  101.      contact Elvish Consulting at the address below for authorization.  This
  102.      authorization will be automatically granted to distributors recognized
  103.      by the (ASP) as adhering to its guidelines for shareware distributors,
  104.      and such distributors may begin offering ELFTREE immediately (However
  105.      Elvish Consulting must still be advised so that the distributor can be
  106.      kept up-to-date with the latest version of ELFTREE.).
  107.  
  108.      You are encouraged to pass a copy of ELFTREE along to your friends for
  109.      evaluation.  Please encourage them to register their copy if they find
  110.      that they can use it.  All registered users will receive a copy of the
  111.      latest version of ELFTREE, a toll-free number for tech support, a
  112.      printed manual, and updates for a nominal fee.
  113.                                                         -- Page 3 --
  114.  
  115.  
  116.  
  117.                      Does Shareware Mean Crippled?
  118.  
  119.      This version has all the functions of the version you'll get when you
  120.      register, but there is an opening message screen, and a delay before
  121.      you can start using the product.  Also, this version does not have
  122.      any additional progams you can get when you register for the full
  123.      version: editor, external viewers, etc.  Read on for information on
  124.      how to get these valuable enhancements.
  125.  
  126.      You are free to use ELFTREE for 30 days, to test it and to determine
  127.      if it is useful to you.  If you are still using it after 30 days, you
  128.      must register with us.  The file ORDER.DOC, included with this package,
  129.      has an order form.  Just fill out the form, print it, and mail it to
  130.      us along with your check or money order.
  131.  
  132.      When you register with us, you get the latest version of ELFTREE,
  133.      with all reported bugs fixed, with any new or enhanced features
  134.      that may have been incorporated, a professionally printed manual,
  135.      a toll-free number for tech support, notices of updates as they
  136.      become available, and one FREE update.  In addition, you can get the
  137.      ELFTREE editor, any viewer(s) we've developed, and a flat-file
  138.      database sort program.  This is a great value for you!  More
  139.      importantly, you make us want to keep improving ELFTREE so that
  140.      it can do even more for you!
  141.  
  142.                              Cheap Upgrades!
  143.  
  144.      Once you license ELFTREE, you can upgrade to the latest registered
  145.      version at a nominal cost.  Through December 31, 1992, this fee is
  146.      $5, a very reasonable cost for you.
  147.  
  148.                        ELFTREE System Requirements
  149.  
  150.      ELFTREE requires you to have a screen so that you can see what it
  151.      shows you, a keyboard to give it commands, and some memory to hold
  152.      information.  You determine how much memory it needs (minimum is
  153.      about 150K free) by customizing it, whether by command-line switches
  154.      (see end of this document) or with the [F4] key once it first comes
  155.      up for you.  It can take advantage of EGA or VGA displays, it works
  156.      with the largest hard disks (even under DOS 3.31 and above), it works
  157.      on all DOS-compatible networks, etc.  In other words, it has modest
  158.      requirements, and it should run on any hardware you've got.  ELFTREE
  159.      will operate much faster on a particular machine with disk caching
  160.      enabled than with disk caching turned off.  ELFTREE understands FAT
  161.      and other system tables under DOS, but it only reads this information.
  162.      It NEVER writes it.
  163.                            Environment Variables
  164.  
  165.     ELFTREE recognizes the following optional environment variables:
  166.  
  167.         ELFTREEPATH - For DOS 2.X, specifies where ELFTREE files are stored.
  168.         ETFIND      - Specifies where to store menus, tree maps, etc.
  169.         ETMAP       - Specifies where to store tree maps for removable
  170.                        drives (such as Bernoulli cartridges, optical
  171.                        media and floppy disks).
  172.         ETCONFIG    - Specifies the configuration file to use.
  173.         ETDRIVES    - Specifies a default selection of drives to search
  174.                        when using the FIND command.
  175.                                                         -- Page 4 --
  176.  
  177.  
  178.                             Introduction
  179.  
  180.      ELFTREE is designed to simplify your goal of getting the most out of
  181.      your computer.  The heart of the program is a powerful, intuitive
  182.      and marvelously integrated file, directory and application manager.
  183.      With it, you can install software in record time, move files from
  184.      one place to another (even across a network!) with ease, and locate
  185.      files fast on even the largest hard disk, regardless of whether you
  186.      use DOS 2.X, 3.X or 4.X, or 4DOS!  You won't believe how easy it is
  187.      to run a program from within ELFTREE, or to customize it to suit your
  188.      tastes.  You will see in all of ELFTREE's features that great care
  189.      was taken to marry great power with extreme convenience.  The result
  190.      is a delightful product that can help you be more effective in how
  191.      you use your computer.
  192.  
  193.                         What Makes ELFTREE Special?                                What Makes ELFTREE Special?
  194.  
  195.        1. Flexible Capacity - You tell ELFTREE how many directories and
  196.             files you want to handle.  For example, you can work with up
  197.             to 16,384 files from 1000 directories across 26 disks with
  198.             ELFTREE's Find feature!
  199.  
  200.        2. Extraordinary Editing - ELFTREE's editor can handle as many files
  201.             as will fit into memory, or it will let you use your own editor.
  202.             Our editor takes about 30K of disk space, yet has storable
  203.             keyboard macros, speedy search & replace, column and block
  204.             operations, and easy customizability!
  205.  
  206.        3. Breathtaking Views - Viewing a file in ELFTREE is a treat.
  207.             Besides a raft of customizable settings (which can be
  208.             programmed by file extension), it has block operations that
  209.             allow you to fix damaged files while viewing them, a
  210.             translator for IBM EBCDIC files, and the ability to search
  211.             forward or backward for text.
  212.  
  213.        4. Also Noteworthy - Attach short notes to files in any directory.
  214.             You'll always know the contents of your files by glancing at
  215.             your notes.  If you use 4DOS, ELFTREE will read/write 4DOS
  216.             note files directly if you start it up with the /4 command-line
  217.             switch to activate this feature.
  218.  
  219.        5. Menu Magic - Powerful menuing features are built into ELFTREE.
  220.             Define up to 13 main menus, each of which can nest submenus up
  221.             to 10 levels deep with 20 selections apiece.  Program your
  222.             menus (!) with symbols to insert keys ahead of a program,
  223.             repeat commands, create internal keyboard macros, prompt a
  224.             user for a reply before executing a command, etc.
  225.  
  226.        6. Convenience - you customize many ELFTREE settings from within;
  227.             there's no separate configuration program.  You can run a
  228.             program by highlighting it and tapping [ENTER].  ELFTREE can
  229.             be trained to associate file extensions with programs, and
  230.             will automatically launch the corresponding program when you
  231.             tap [ENTER] on a file with such an extension.  ELFTREE can
  232.             also speed up or slow down your keyboard.
  233.                                                         -- Page 5 --
  234.  
  235.  
  236.        7. Video Joy - For EGA or VGA displays, ELFTREE can switch you into
  237.             28/43/50 line modes with the touch of a key [Ctrl-V].  Also,
  238.             ELFTREE recognizes non-standard modes and accommodates them.
  239.  
  240.        8. Brains - When you choose an option, ELFTREE anticipates your
  241.             next need, where possible.  For example, when you:
  242.  
  243.               a. Rename a directory, the tree is adjusted automatically.
  244.               b. Attempt to use an unformatted floppy disk, ELFTREE will
  245.                   let you format it immediately (even if you are in the
  246.                   middle of copying files).
  247.               c. Create a directory in the middle of specifying where
  248.                   to copy or move files, ELFTREE will highlight the
  249.                   new directory for you.
  250.               d. Select a menu option that has a submenu, ELFTREE will
  251.                   highlight the most likely submenu option for you.
  252.               e. Rename an item with spaces in the name, the spaces are
  253.                   conveniently removed for you.
  254.  
  255.        9. Trim - When ELFTREE runs a program, it reserves less than 3K for
  256.             itself, leaving plenty of room to run memory-hungry programs.
  257.             You can also make ELFTREE use 0K, which may be needed to load
  258.             TSR's, change environment variables, etc.
  259.  
  260.       10. Power - Copy, move, protect, edit, print, rename,locate and hide
  261.             files quickly and easily.  Rename, protect, hide, locate, copy,
  262.             move, graft, create and delete directories just as easily.
  263.             Sort the file display 3,584 ways; rearrange them still further
  264.             for such necessities as printing several files so that they'll
  265.             be properly collated.  Tag files 8 ways for group operations.
  266.             ELFTREE remembers your last 15 commands, and gives you a
  267.             convenient way to retrieve them.  Change file dates and times.
  268.             Create groups of files for special operations.
  269.                                                         -- Page 6 --
  270.  
  271.  
  272.                             INSTALLATION
  273.  
  274.      To install it, just copy the files into whatever hard disk
  275.      directory you want to start it from.  To start it up, just
  276.      type:   ET    and tap [ENTER].
  277.  
  278.  
  279.      These are the files that should have been included in the ELFTREE
  280.      package.  If any are missing, please call us at (217) 698-8600 to
  281.      correct it.
  282.  
  283.          ET.EXE        - starts up the program
  284.          ETT.BAT       - used when ELFTREE runs a program in 0K RAM.
  285.          ELFTREE.CHL   - part of the program
  286.          AUTOEXEC.DOC  - examples of SET ELFTREEPATH, PATH commands
  287.          README.DOC    - this file
  288.          ORDER.DOC     - Invoice for ordering ELFTREE
  289.          SAMPLE.ETU    - Sample menu file
  290.          SITELICE.DOC  - Site license agreement
  291.          ELFTREE.HLP   - Help file (Think of it as on-disk manual)
  292.  
  293.  
  294.                        DOS 2.X CONSIDERATIONS
  295.  
  296.      If you have DOS 2.X, you need to give the following command
  297.      before you can successfully bring up ELFTREE:
  298.  
  299.          SET ELFTREEPATH=C:\TREE    (use the directory ET is installed in)
  300.  
  301.      It is recommended that you put this command in your AUTOEXEC.BAT file.
  302.  
  303.                               ORDERING
  304.  
  305.      If you like ELFTREE, order it!  When you order, you get the most
  306.      recent version of the software, an editor that can handle multiple
  307.      files at once, a dBase viewer, a toll-free support number, a
  308.      professionally printed wire-spiral-bound, manual and notices of
  309.      updates to ELFTREE (your first update is FREE).  If you prefer,
  310.      you can order ELFTREE without the editor and viewers.
  311.      
  312.      See the file ORDER.DOC for an invoice.
  313.  
  314.      We hope you enjoy using all of ELFTREE's features.
  315.  
  316.             Elvish Consulting
  317.             1408 Noble Avenue
  318.             Springfield, IL 62704
  319.             (217) 698-8600
  320.                                                         -- Page 7 --
  321.  
  322.  
  323.  
  324.                       ELFTREE Command-Line Switches
  325.    __________________________________________________________________________
  326.  
  327.      In addition to the customize menu, you can configure ELFTREE with
  328.      certain command-line switches that you type after the ET that gets
  329.      ELFTREE up and running.  Here are the switches that may be used,
  330.      and what they represent:
  331.  
  332.          /#=<char>- If you prefer not to use '#' as the symbol that
  333.               identifies a macro symbol (for example, you may
  334.               have files that have '#' in their names), use
  335.               this to select another symbol.  For example, to
  336.               make '+' the symbol, use /#=+
  337.          /4       - Use 4DOS-style note files (file name DESCRIPT.ION).
  338.          /5       - Use ET-style note files (file name ELFTREE.NTE).
  339.          /C       - if you have a composite monitor.
  340.          /D=####  - Set maximum number of directories to handle.  Each
  341.               one uses 16 bytes.
  342.               (max is 3,999; default is 200)
  343.          /F=####  - This sets the maximum number of files to handle.
  344.                    Each one use 22 bytes.
  345.               (min is 50, max is 16384; default is 1500)
  346.          /G=####  - Set maximum number of directories to handle with the
  347.               Find feature.  Each one uses 64 bytes.
  348.               (max is 999; default is 50)
  349.          /H=#     - If # is 1, this activates high-speed disk scanning
  350.               routines for normal, non-networked drives.
  351.               (default is 1, or ON; /H=0 turns it off)
  352.               Note: A separate logical variable is maintained
  353.                 for high-speed scanning in the OS/2
  354.                 Compatibility Box.  This switch affects
  355.                 only that variable's setting.
  356.          /K=####  - If # is at least 10, this refers to the number
  357.               of internal macro keys to allow.
  358.               (max is 5000; default is 100)
  359.          /L=Z     - Last drive accessible to user.
  360.               (default is Z; C-Z is allowed)
  361.          /N=####  - Set maximum number of notes to handle.  Each one
  362.               uses 64 bytes; the space is shared with /G=####.
  363.               (max is 999; default is 50)
  364.          /R=###   - ASCII code of `retag' character to use (1-255).
  365.               (default is 9, which looks like a hollow circle)
  366.          /T=###   - ASCII code of `tag' character to use (1-255).
  367.               (default is 4, which looks like a solid diamond)
  368.          /U=####  - if #### is at least 500, this sets the maximum
  369.               allowable length of a menu command line.
  370.               (max is 10,000; default is 500)
  371.          /Y=#     - If you do not have an enhanced keyboard, but you
  372.               want ELFTREE to think that you do (this will let
  373.               you use [Ctrl-Del] and other nonstandard keys),
  374.               use 1 for #.  Use 0 for # if you do not want
  375.               ELFTREE to use any of the enhanced keyboard
  376.               facilities, even if you have such a keyboard.
  377.               (default is 1 if an enhanced keyboard is detected,
  378.               and 0 if not; /Y=1 activates enhanced support)
  379.  
  380.     Here is an example of how to set up ELFTREE to use 2,000 files,
  381.     300 directories and 500 notes per directory:
  382.  
  383.         ET /F=2000 /D=300 /N=500
  384.